home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / dev / mui / MCC_Readargsgr.lha / Readargsgroup / Developer / AutoDocs / MCC_Readargsgroup.doc
Encoding:
Text File  |  1998-09-13  |  2.4 KB  |  71 lines
  1. TABLE OF CONTENTS
  2.  
  3. Readargsgroup.mcc/Readargsgroup.mcc
  4. Readargsgroup.mcc/MUIA_Readargsgroup_Key
  5. Readargsgroup.mcc/MUIA_Readargsgroup_Args
  6. Readargsgroup.mcc/Readargsgroup.mcc
  7.  
  8. This class creates a group of GUI elements based on Readargs-compatible
  9. template. That's the way AmigaMesaRTL output handlers show their parameters
  10. and get user specified settings.
  11.  
  12. I hope it will be useful for someone. BTW it's the most compact GUI
  13. representation in the world... :-)
  14.  
  15.  
  16. Author: Szymon Ulatowski <szulat@friko6.onet.pl>
  17.  
  18. Readargsgroup.mcc/MUIA_Readargsgroup_Key
  19.  
  20.     NAME
  21.     MUIA_Readargsgroup_Key -- [I.G], char *
  22.  
  23.     FUNCTION
  24.    You have to specify the template at init time. The string is copied into
  25.    private buffer.
  26.    Most of standard Readargs features are supported (/M,/K,/S,/N)
  27.    Normal arguments are turned in string gadgets, /N's become integer
  28.    gadgets, /S are shown as checkboxes.
  29.    You can define abbreviations as usual (ABBR=ABBREVIATION).
  30.    Moreover it has some extensions (compatible with the original):
  31.    
  32.     - underscores '_' in the argument's names are converted to spaces in
  33.       GUI labels
  34.  
  35.     - special codes can be put in argument's names to create additional GUI
  36.       elements:
  37.  
  38.       _LA_any_text - creates a label
  39.       _LA1_any_text - a label with horizontal bar
  40.          labels should be specified as keywords (/K) so they will not cause
  41.          arguement strings to be longer
  42.  
  43.       _FN_argument - string gadget with filename popup 
  44.       _FO_argument - ... with font popup (format: fontname/size) 
  45.       _SM_argument - ... with screenmode popup (format: 0xHEXNUMBER)
  46.  
  47.       _MX_switch/S,_MX_secondswitch/S,...
  48.         MX turns a set of checkboxes into mutual exclude radiobutton
  49.         switches beginning with _MX1_ form the second radiobutton group
  50.         _MX2_ - third and so on
  51.  
  52.  
  53.      See AmigaMesaRTL output handlers sources for examples.
  54.  
  55.     BUGS
  56.    Argument type /M is not fully supported. Only the first word is read
  57.    in the gui. In filename requesters it should provide a multiselect
  58.    capabilities but it doesn't... :-(
  59.  
  60. Readargsgroup.mcc/MUIA_Readargsgroup_Args
  61.  
  62.     NAME
  63.     MUIA_Readargsgroup_Args -- [ISG], char *
  64.  
  65.     FUNCTION
  66.    With this argument you can put values into GUI elements.
  67.    Your argument string will be parsed by ReadArgs, of course.
  68.    Getting MUIA_Readargsgroup_Args gives you the ReadArgs compatible string
  69.    containing user specified values.
  70.  
  71.